home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / SCSL / dlaed9.z / dlaed9
Encoding:
Text File  |  2002-10-03  |  4.6 KB  |  133 lines
  1.  
  2.  
  3.  
  4. DDDDLLLLAAAAEEEEDDDD9999((((3333SSSS))))                                                          DDDDLLLLAAAAEEEEDDDD9999((((3333SSSS))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      DLAED9 - find the roots of the secular equation, as defined by the values
  10.      in D, Z, and RHO, between KSTART and KSTOP
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      SUBROUTINE DLAED9( K, KSTART, KSTOP, N, D, Q, LDQ, RHO, DLAMDA, W, S,
  14.                         LDS, INFO )
  15.  
  16.          INTEGER        INFO, K, KSTART, KSTOP, LDQ, LDS, N
  17.  
  18.          DOUBLE         PRECISION RHO
  19.  
  20.          DOUBLE         PRECISION D( * ), DLAMDA( * ), Q( LDQ, * ), S( LDS, *
  21.                         ), W( * )
  22.  
  23. IIIIMMMMPPPPLLLLEEEEMMMMEEEENNNNTTTTAAAATTTTIIIIOOOONNNN
  24.      These routines are part of the SCSL Scientific Library and can be loaded
  25.      using either the -lscs or the -lscs_mp option.  The -lscs_mp option
  26.      directs the linker to use the multi-processor version of the library.
  27.  
  28.      When linking to SCSL with -lscs or -lscs_mp, the default integer size is
  29.      4 bytes (32 bits). Another version of SCSL is available in which integers
  30.      are 8 bytes (64 bits).  This version allows the user access to larger
  31.      memory sizes and helps when porting legacy Cray codes.  It can be loaded
  32.      by using the -lscs_i8 option or the -lscs_i8_mp option. A program may use
  33.      only one of the two versions; 4-byte integer and 8-byte integer library
  34.      calls cannot be mixed.
  35.  
  36. PPPPUUUURRRRPPPPOOOOSSSSEEEE
  37.      DLAED9 finds the roots of the secular equation, as defined by the values
  38.      in D, Z, and RHO, between KSTART and KSTOP. It makes the appropriate
  39.      calls to DLAED4 and then stores the new matrix of eigenvectors for use in
  40.      calculating the next level of Z vectors.
  41.  
  42.  
  43. AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  44.      K       (input) INTEGER
  45.              The number of terms in the rational function to be solved by
  46.              DLAED4.  K >= 0.
  47.  
  48.      KSTART  (input) INTEGER
  49.              KSTOP   (input) INTEGER The updated eigenvalues Lambda(I), KSTART
  50.              <= I <= KSTOP are to be computed.  1 <= KSTART <= KSTOP <= K.
  51.  
  52.      N       (input) INTEGER
  53.              The number of rows and columns in the Q matrix.  N >= K (delation
  54.              may result in N > K).
  55.  
  56.      D       (output) DOUBLE PRECISION array, dimension (N)
  57.              D(I) contains the updated eigenvalues for KSTART <= I <= KSTOP.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. DDDDLLLLAAAAEEEEDDDD9999((((3333SSSS))))                                                          DDDDLLLLAAAAEEEEDDDD9999((((3333SSSS))))
  71.  
  72.  
  73.  
  74.      Q       (workspace) DOUBLE PRECISION array, dimension (LDQ,N)
  75.  
  76.      LDQ     (input) INTEGER
  77.              The leading dimension of the array Q.  LDQ >= max( 1, N ).
  78.  
  79.      RHO     (input) DOUBLE PRECISION
  80.              The value of the parameter in the rank one update equation.  RHO
  81.              >= 0 required.
  82.  
  83.      DLAMDA  (input) DOUBLE PRECISION array, dimension (K)
  84.              The first K elements of this array contain the old roots of the
  85.              deflated updating problem.  These are the poles of the secular
  86.              equation.
  87.  
  88.      W       (input) DOUBLE PRECISION array, dimension (K)
  89.              The first K elements of this array contain the components of the
  90.              deflation-adjusted updating vector.
  91.  
  92.      S       (output) DOUBLE PRECISION array, dimension (LDS, K)
  93.              Will contain the eigenvectors of the repaired matrix which will
  94.              be stored for subsequent Z vector calculation and multiplied by
  95.              the previously accumulated eigenvectors to update the system.
  96.  
  97.      LDS     (input) INTEGER
  98.              The leading dimension of S.  LDS >= max( 1, K ).
  99.  
  100.      INFO    (output) INTEGER
  101.              = 0:  successful exit.
  102.              < 0:  if INFO = -i, the i-th argument had an illegal value.
  103.              > 0:  if INFO = 1, an eigenvalue did not converge
  104.  
  105. FFFFUUUURRRRTTTTHHHHEEEERRRR DDDDEEEETTTTAAAAIIIILLLLSSSS
  106.      Based on contributions by
  107.         Jeff Rutter, Computer Science Division, University of California
  108.         at Berkeley, USA
  109.  
  110.  
  111. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  112.      INTRO_LAPACK(3S), INTRO_SCSL(3S)
  113.  
  114.      This man page is available only online.
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.